DICE API Documentation/com.embabel.dice.query.discovery

Package-level declarations

Types

data class CollectorDryRunDto(val runId: String, val dryRun: Boolean, val applied: Int, val skipped: Int, val hardDeleted: Int, val marks: List<MarkDto>)

A leak-free summary of a collector dry-run preview. Exposes counts derived from the run's list fields, plus the individual marks.

DiscoveryProvenanceDto

data class DiscoveryProvenanceDto(val locator: String, val sourceRevision: String? = null, val chunkId: String? = null, val startOffset: Int? = null, val endOffset: Int? = null, val contentHash: String? = null)

Primitive-only provenance attached to a discovery explanation.

DiscoveryQuery

data class DiscoveryQuery(val mode: RetrievalMode, val text: String? = null, val entityId: String? = null, val from: Instant? = null, val to: Instant? = null, val topK: Int = 10, val depth: Int = 1, val similarityThreshold: Double = 0.0)

A leak-free request for the discovery surface.

DiscoveryResult

data class DiscoveryResult(val mode: RetrievalMode, val supported: Boolean, val propositions: List<PropositionSummaryDto>)

The result of a discovery retrieval.

EntityMentionSummaryDto

data class EntityMentionSummaryDto(val name: String, val type: String, val resolvedId: String?, val role: String)

A leak-free summary of a single entity mention, modelled on the proven web-layer shape.

LineageDto

data class LineageDto constructor(val propositionId: String, val text: String, val status: String, val reinforceCount: Int, val groundingChunkIds: List<String>, val sourceSummaries: List<String>, val provenance: List<DiscoveryProvenanceDto> = emptyList())

A leak-free lineage summary — the "why" behind a stored fact.

MarkDto

data class MarkDto(val propositionId: String, val reason: String, val strategyName: String)

A leak-free summary of a single collector mark.

NeighborhoodDto

data class NeighborhoodDto(val centerEntityId: String, val via: List<PropositionSummaryDto>)

A leak-free summary of an entity neighbourhood: the edge propositions reachable from the centre.

PathDto

data class PathDto(val entityIds: List<String>, val edges: List<PropositionSummaryDto>)

A leak-free ordered path between two entities.

ProjectionHealthDto

data class ProjectionHealthDto(val perTarget: List<TargetHealthDto>)

Projection health: lifecycle counts aggregated per target.

PropositionSummaryDto

data class PropositionSummaryDto(val id: String, val text: String, val confidence: Double, val status: String, val mentions: List<EntityMentionSummaryDto>, val grounding: List<String>)

A lean proposition summary — the common shape every discovery result maps down to.

RetrievalMode

enum RetrievalMode : Enum<RetrievalMode>

The retrieval policy selecting which capability fragment a discovery request routes to.

RetrievalRouter

class RetrievalRouter(store: PropositionStore, graphQuery: GraphQuery, contextId: <Error class: unknown class>)

The single retrieval router shared by every discovery presentation tier (MCP tools, REST).

TargetHealthDto

data class TargetHealthDto(val target: String, val projected: Int, val adopted: Int, val skipped: Int, val failed: Int, val stale: Int)

Per-target projection counts by lifecycle.